package com.xs.shop.content.service.service;


import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.xs.shop.content.model.entity.DocCategory;

/**
 * <p>
 *  文档分类服务类
 * </p>
 *
 * @author xs
 * @since 2025-07-16
 */
public interface DocCategoryService extends IService<DocCategory> {

    /**
     * 新增文档分类
     * @param docCategory 文档分类信息
     * @return 新增的文档分类
     */
    DocCategory addCategory(DocCategory docCategory);

    /**
     * 软删除文档分类
     * @param id 文档分类ID
     * @return 是否删除成功
     */
    boolean deleteCategory(Long id);

    /**
     * 编辑文档分类
     * @param docCategory 文档分类信息
     * @return 更新后的文档分类
     */
    DocCategory updateCategory(DocCategory docCategory);

    /**
     * 根据ID查询文档分类
     * @param id 文档分类ID
     * @return 文档分类信息
     */
    DocCategory getCategoryById(Long id);

    /**
     * 分页查询文档分类
     * @param current 当前页
     * @param pageSize 每页条数
     * @param name 分类名称
     * @param isShow 是否显示
     * @return 分页结果
     */
    Page<DocCategory> pageCategory(Integer current,Integer pageSize, String name, Byte isShow);
}
